home *** CD-ROM | disk | FTP | other *** search
/ Celestin Apprentice 2 / Apprentice-Release2.iso / Tools / MPW / lgrind 1.0.1 / lgrind.README < prev    next >
Encoding:
Text File  |  1993-05-10  |  3.2 KB  |  83 lines  |  [TEXT/MPS ]
  1. ••• Information about the Apple Macintosh MPW tool "lgrind". •••
  2.  
  3. Usage:
  4.  
  5. As under Unix.  See the manpages lgrind.man and lgrindefs.man.
  6.  
  7.  
  8.  
  9. Known bugs in the MPW port:
  10.  
  11. • The tool sometimes produces a system error on a Mac IIsi+FPU if it is
  12.   executed without command line options and subsequently interrupted with
  13.   command-dot.  An alert box is generated which says:
  14.            Sorry, a system error occurred
  15.            ``MPW Shell''
  16.            unimplemented trap  (continue)  (restart)
  17.   This might be caused by the GUSI/Unix functions or it might be related to
  18.   a well-known problem in the MPW Shell: MPW tools compiled with the FPU
  19.   options crash if they are interrupted.
  20. • Some options seem to have no effect, as under Unix.
  21.  
  22.  
  23.  
  24. Files:
  25.  
  26. :possible-hacks    -- suggestions for modifications of lgrind.  Unused.
  27. doc-lgrind.lg    -- file to test lgrind on:  it typesets the lgrind source files.  Not needed.
  28. docstrip.cmd    -- Not needed.
  29. docstrip.tex    -- Not needed.
  30. fancyhead.doc    -- LaTeX stuff needed by lgrind.  Put it in your :TeX:inputs folder.
  31. fancyhead.sty    -- LaTeX stuff needed by lgrind.  Put it in your :TeX:inputs folder.
  32. lgrind            -- the MPW tool.  Put it in your {MPW}Tools folder.
  33. lgrind.1        -- the lgrind manpage.  Useful under Unix only.  See: lgrind.man.
  34. lgrind.c        -- source for Apple Macintosh MPW.
  35. lgrind.c-orig    -- the original Unix source.
  36. lgrind.doc        -- LaTeX stuff needed by lgrind.  Put it in your :TeX:inputs folder.
  37. lgrind.make        -- the makefile for Apple Macintosh MPW.
  38. lgrind.man        -- readable (nroff-ed) version of the original file lgrind.1.
  39. lgrind.Re        -- newsgroup posting about bugs in lgrind.  Original Unix stuff.
  40. lgrind.README    -- << this file >>
  41. lgrind.sty        -- LaTeX stuff needed by lgrind.  Put it in your :TeX:inputs folder.
  42. lgrindefs        -- language definitions file.  Its FORTRAN section is ``improved''.  See Note 1.
  43. lgrindefs-orig    -- original Unix version of lgrindefs.
  44. lgrindefs.5        -- the lgrindefs manpage.  Useful under Unix only.  See: lgrindefs.man.
  45. lgrindefs.man    -- readable (nroff-ed) version of the original file lgrindefs.5.
  46. makefile-orig    -- the original Unix makefile.
  47. malloc.h        -- patch for MPW.    
  48. regexp.c        -- part of lgrind.
  49. retest.c        -- test code.  Unused.
  50. v2lg.c            -- test code.  Unused.
  51. vgrindefs.c        -- part of lgrind.
  52.  
  53. Note 1: If you don't use the lgrind -d option then lgrind looks for a file with a
  54.         name as specified in the variable DEFSFILE makefile "lgrind.make".
  55.  
  56.  
  57.  
  58.  
  59. Entry for your MPW.Help file:
  60.  
  61. -
  62. lgrind            # formats program sources in a nice style using LaTeX
  63. lgrind [option…] file… > LaTeXoutput
  64.     -h <header>                # specifies text to go on the left side of every output page
  65.     -                        # take input from standard input (options after "-" are ignored)
  66.     -e                        # process a LaTeX file for embedded text
  67.     -i                        # process for inclusion in a LaTeX document
  68.     -n                        # don't boldface keywords
  69.     -c                        # Don't treat @, etc. specially in comments
  70.     +c                        # Do treat @, etc. specially in comments
  71.     -a                        # Don't treat @, etc. specially in LaTeX text (@embed@ only)
  72.     +a                        # Do treat @, etc. specially in LaTeX text (@embed@ only)
  73.     -t                        # Use \tt for all fonts
  74.     -l<lang>                # specifies the language to use
  75.     -d <lgrindefs>            # specifies the language definitions file
  76.  
  77.  
  78.  
  79. _____________________________________
  80. Fred Walsteijn  (walsteyn@fys.ruu.nl)
  81. May 9, 1993
  82.  
  83.